Release 10.1A: OpenEdge Development:
Web Services

Client interface methods for session-managed AppObjects

A session-managed AppObject provides the following methods.

Use this method to connect to an AppServer:

Connect_AppObject (...)

This method must be executed before any other method can be called. The SOAP response header returned by this method contains an AppObjectID element whose value must be sent in the SOAP request header for all other methods invoked on this AppObject.

Use this method to release the AppObject connection:

Release_AppObject ( )

Once this method is executed, no other methods on the AppObject can be called. The SOAP request header must contain the value of the AppObjectID element. If other objects (SubAppObjects or ProcObjects) are using the same connection, the connection is not terminated until the corresponding release method is called on every object.

Use this method to create a SubAppObject:

CreateAO_SubAppObject ( )

This method must be executed before calling any other methods on the SubAppObject. The SOAP request header must contain the value of the AppObjectID element. The SOAP response header returned by this method contains a SubAppObjectID element whose value must be sent in the SOAP request header for all methods invoked on this SubAppObject.

Use this method to create a ProcObject and execute the corresponding persistent procedure:

CreatePO_ProcObject (...)

This method must be executed before calling any other methods on the ProcObject. The SOAP request header must contain the value of the AppObjectID. The SOAP response header returned by this method contains a ProcObjectID whose value must be sent in the SOAP request header for all methods invoked on this ProcObject.

Call a ProcName method on the AppObject to execute a corresponding non-persistent external procedure typically identified by ProcName:

ProcName (...)

The SOAP request header must contain the value of the AppObjectID element.